前言¶
用 DeepSeek Harness（DSH）接微信或自建助手时，常见做法是再配一套任务 App：消息在聊天里，安排却要复制到日历或清单，改时间还要两边找记录。DSH 社区插件 telos-harness（维护者 lucifersteps，分类为联网工具）把这条链路收在 Mac 上的 DSH 进程里：你在微信里用自然语言、截图或语音交代事务，助手整理后经你确认写入 Apple 日历与提醒事项，并支持定时微信提醒、网页阅读、百度地图等能力。下文介绍它是什么、能做什么，以及如何在 DSH 桌面版或 CLI 上安装与验收。
这是什么¶
Telos 是面向 iPhone + Mac 场景的 DSH 插件：在 Mac 上运行 DSH 与 Telos，通过微信与助手对话，把工作和生活中的安排落到 Apple 日历 与 Apple 提醒事项，减少在微信与管理 App 之间来回切换。插件在 GitHub 仓库 lucifersteps/telos-harness 发布，当前文档对应版本 0.4.12，许可证为 MIT；社区目录页见 SkillHub 插件条目。
运行环境有明确边界：macOS 14 及以上、Apple Silicon（M 系列）；官方说明目前不支持 Intel Mac、Windows、Linux。已验证宿主为 DSH 0.2.1-rc.2 的桌面版与 Node/CLI。若希望随时通过微信使用并收到定时消息，需要 Mac 保持联网、唤醒，并持续运行 DSH 与 Telos。
核心功能¶
下列能力均来自项目 README 的功能表与说明；涉及日历、提醒事项的创建、修改或删除时，会先展示预览，收到你的文字确认后再执行。
| 方向 | 说明 |
|---|---|
| Apple 日历 | 查询、创建、修改、删除日程 |
| Apple 提醒事项 | 查询、新增、修改、完成、删除待办 |
| 微信定时任务 | 定时发微信、按计划执行查询；可查看、修改、取消 |
| 网页搜索与阅读 | 搜索资料、读取公开网页、整理内容（依赖 DSH 网页服务） |
| 百度地图 | 地点、地址、公交与驾车路线、天气（需单独配置 SK） |
| 用户记忆 | 保存与更新称呼、偏好等长期信息 |
| 历史回查 | 检索当前微信会话旧消息（含压缩前内容及前后文） |
| 图片与语音 | 理解图片、识别语音，整理为回答或操作草稿 |
| 文件读取 | PDF 文字层、DOCX、XLSX 及文本；复用 DSH Office 相关能力 |
| 人设与 Skill | 内置或自定义人设，使用 DSH 中适用的 Skill |
地图功能需在 百度地图 Agent Plan 获取 SK，填入 Telos 的「百度地图 Token」或配置项 BAIDU_MAP_AUTH_TOKEN；普通地图 Web API 的 AK 不适用此处。语音依赖 DSH 中的语音识别服务；历史回查仅限当前微信会话。
安装与启用¶
安装包为预构建的 .tgz，不要用源码 ZIP 或 github:lucifersteps/telos-harness 代替（源码不含已编译的 Python 与 Apple 组件）。市场安装来源与 Release 一致：
https://github.com/lucifersteps/telos-harness/releases/download/v0.4.12/telos-harness-0.4.12-macos-arm64.tgz
同一 Release 提供 SHA256 校验文件，安装前应按仓库 AI 安装指南 核对。
DSH 桌面版（推荐首次使用）¶
- 从 DSH 官网 安装兼容版本并打开应用。
- 下载与文档版本匹配的
telos-harness-版本-macos-arm64.tgz并完成校验。 - 在 DSH 中选择「插件 → 添加插件」，安装该文件并启用，打开 Telos 页面。
- 配置模型连接（可复用已有配置或账号登录/API Key），「测试连接」成功后按需开启 Apple 与百度地图，点击「保存并应用」。
- 在 Telos 页面完成微信扫码，点击「授权日历与提醒事项」，在 macOS 弹窗中分别允许。
- 点击「启动 Telos」，用已扫码微信发送测试消息并试查日程与提醒事项。
安装包自带 Telos 所需的 Python 运行环境与 Apple 组件，无需单独安装 Python、Homebrew 或 Xcode。当前安装包为 ad-hoc 签名；若系统拦截，见仓库 排障指南。
DSH CLI¶
按仓库 CLI 安装步骤 创建或复用含 dsh-base 的 profile，配置模型凭据，再完成首次配置、微信登录、Apple 授权与启动。CLI 与桌面共用同一 .tgz；CLI 进程需保持运行，关闭终端、退出 DSH 或休眠时无法正常收消息与触发定时任务。不要对同一微信账号同时运行两个 Telos 实例。
也可将「帮我安装 Telos」与仓库链接交给能操作本机的 AI，并让其阅读 docs/install-for-ai.md；密钥、扫码与 macOS 授权仍由本人完成，勿把 API Key 或登录文件贴进聊天。
典型用法¶
下列表述来自 README 示例，可在微信中直接尝试（需已完成模型与微信配置；Apple 功能需已授权）：
- 日程：「看看我明天有哪些安排。」「明天下午三点安排一小时项目讨论。」
- 提醒：「周五下午五点前提醒我提交报销材料，保存到 Apple 提醒事项。」「把『买牛奶』标记为已完成。」
- 定时：「十分钟后在微信提醒我休息。」「每天早上九点，把当天日程和未完成事项发给我。」
- 网页：「查一下这个项目的官方安装文档。」「读一下这个链接，整理主要结论。」
- 地图：「从北京南站到颐和园，坐地铁怎么走？」「查询杭州明天的天气。」
- 记忆：「记住，我喜欢简短直接的回复。」
- 多媒体与文件：发送活动海报截图，要求提取时间地点并整理成日程草稿；或发送 PDF/Word 等，要求整理会议或总结要点。
验收安装成功时，官方建议：Telos 已启动且模型可用；微信能收到对测试消息的实际回复；日历与提醒事项权限已允许且只读查询成功。需要测定时任务时，可创建「一分钟后提醒我安装测试完成」的一次性任务，并保持电脑唤醒与 DSH、Telos 运行。
适用场景与注意¶
适合谁： 已在 Mac 上使用 DSH、日常用 iPhone 微信，并希望把安排落在 Apple 日历与提醒事项里的用户；需要网页检索、地图路线或微信定时汇总待办时，可在同一对话里完成，而不必再维护一套独立任务 App。
权限与安全： 插件在 当前 DSH 进程的权限 下运行，可访问你配置的模型、微信通道及已授权的 Apple 数据。安装前应阅读仓库源码与 MIT 许可证，以及 第三方声明；不要把 API Key、微信登录文件或完整聊天日志粘贴到 AI 聊天或 GitHub。
额外配置摘要：
| 功能 | 准备 |
|---|---|
| 微信聊天 | DSH 模型连接、微信扫码 |
| Apple 日历与提醒 | macOS 两项权限；写入前文字确认 |
| 百度地图 | Agent Plan SK，可选 |
| 网页搜索与读取 | DSH 网页服务与凭据 |
| 语音 | DSH 语音识别服务，可选 |
社区插件目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，Telos 是其中面向微信 + Apple 原生日历栈的一条实现路径。
结尾¶
Telos Harness 把「在微信里随口记安排」和「数据落在 Apple 日历与提醒事项」接在一起，并扩展定时微信、网页、地图与会话记忆等联网相关能力；安装以 0.4.12 的 telos-harness-*-macos-arm64.tgz 为准，在 DSH 中添加插件后完成模型、微信与 Apple 授权即可上手。更多步骤见 GitHub README 与 install-for-ai.md；问题可查 troubleshooting.md。
