夜雨聆风
去实战，拿结果
今天想在Obsidian里面，
安装opencode-obsidian和obsidian-terminal两个插件，
实现"笔记+AI+终端"的无缝闭环。
本以为按照文档clone下来就能用，结果下午折腾两小时，
这一路全是"野路子"报错，但也总结了实战经验，
给想自己动手折腾插件的伙伴排个雷。
🕳️ 第一坑：GitHub克隆超时
先安装opencode-obsidian插件，
按文档要求，第一步是git clone插件仓库到 .obsidian/plugins/ 目录下。
提示词操作后，进度条卡住：
报错Failed to connect to GitHub.com : Operation timed out。
排查过程：
一开始以为是仓库有问题，换浏览器直接访问也慢得打不开。
很明显，网络波动。
解决方法：
后来发现是网络彻底不通，只能等网络恢复或者换源重试。
这里提醒一句：开发者模式安装插件，第一步clone就卡住了，
建议提前确认网络通畅，或者找好 GitHub 镜像站。
🕳️ 第二坑：Python语法报错引发的"版本问题"
再安装obsidian-terminal插件，
装好依赖后信心满满地打开终端，
结果直接一个红色报错：SyntaxError: invalid syntax，
定位在一行看起来完全正常的 Python 代码上。
排查过程：
检查系统Python版本，
终端里跑python3 --version显示是 3.12，没问题啊？
分析问题：
Obsidian底层是Electron，它调用的Python环境可能走了系统默认的旧版本。插件代码太新，老 Python 根本看不懂。
解决方法：
改默认值没用，因为插件启动时会优先读取用户配置文件 data.json。
手工去 .obsidian/plugins/terminal/data.json 里，找到对应的 profile，把 "pythonExecutable": "python3" 手动改成绝对路径："/usr/local/bin/python3"。
改完重启，终端界面终于出来了。
🕳️ 第三坑：终端里的command not found
终端面板打开了，
但输入opencode时提示找不到命令。
排查过程：
Obsidian调出的终端往往是非交互式Shell，不会自动加载 ~/.zshrc。
打开 .zshrc 一看，
第21行居然混入了一堆 \n 转义字符，导致Shell解析直接崩了。
解决方法：
手动清理了.zshrc里的格式乱码，
加上正确的export PATH="$HOME/.opencode/bin:$PATH"。
确保配置文件干净后，重启Obsidian，命令秒识别。
💡 实战经验总结
1. 别全信终端里的which
外部终端看到的python3路径，和App内部调用的可能根本不是一个。遇到SyntaxError，优先怀疑环境版本不一致，可在配置里写死绝对路径。
2. 配置文件的"优先级陷阱"
改默认值往往会被用户配置覆盖。调试时如果改源码不生效，一定要去 data.json 或缓存里看看是不是有旧值在"作祟"。
3. 环境隔离是常态
GUI软件启动的子进程，环境变量往往是"纯净版"。遇到命令找不到，先假设它没加载你的Shell配置文件，排查方向要对。
如果你也在探索AI一人公司
「AI一人公司工具包」
这是我用10个月跑通的真实AI工作系统，
更是AI商业工作流，做知识库、公域获客、产品变现、轻量交付…
加入“AI一人公司实战群”，免费领取，联系我即可~
👇 如果这篇对你有用
我是澍登，一人公司实践者。
专注于AI工作系统/AI知识库变现，
一人公司用AI工具把知识做成产品及商业化。
关注我，你会持续看到
真实可用AI工作流与实战拆解
知识库 → 产品 → 变现路径
一人公司工具选型和避坑经验
↑ 点击上方蓝字，关注后回复「知识库」，获取我整理的工具清单
·······END·······
限免写作&编程交流群，扫码领取AI资料。
往期推荐：
【一人企业商业化】
【自由职业】
【个人IP】
【自我介绍】
点击👇🏻👇🏻卡片"澍登说"，关注公众号，随时与作者交流，道是“树灯千光照，明月逐人来”！
