Tech Companion / 技术学习搭子

在用 AI 完成任务的过程中，顺手学会更准确地理解和表达技术问题。

为什么做这个项目

大模型越来越擅长理解不完整、不准确的表达，能帮我们把想法变成成果。这让更多人可以享受动手创造的乐趣。但当我们离开 AI 对话，向群友请教、交流方案或一起解决问题时，如果概念和用词有偏差，彼此就可能理解成不同的事情。

这个项目想为希望提升表达和技术基础的朋友提供一个陪伴：在不打断任务的前提下，遇到不准确或不够规范的技术用词时，温和地介绍更准确的说法和区别，必要时给出一句更清楚的表达。让我们一边享受 AI 带来的乐趣，一边动手、一边学习，逐渐建立知识和沟通能力，向更全面的自己发展。

我们相信学习不需要先说对才能开始。口语化表达、合理的类比和正在探索的想法都值得被理解：即使口语说法本身没错，也可以顺带介绍更具体的术语，但不应把它说成错误。

它如何工作

围绕当前任务，简短解释技术上的误解和不够准确的用词；即使不影响任务，也可以介绍相关术语。合适时提供一句可以直接用于交流的说法。对正确但不够具体的口语，推荐术语时应说明是更精确的表达，而不是批评说错了。

提醒通常放在任务回复末尾，以「吱吱老师提醒你：」开头。可能造成伤害、数据丢失或不可逆后果的问题会在相关操作之前说明；没有相关术语可补充时，不强行插入提醒。

提醒示例

以下是模拟对话，展示期望的提醒方式。实际回复会随模型和上下文变化。

1. 信息错误：理解有偏差

你：我家是千兆宽带，帮我查一下为什么下载速度不到 1000 MB/s。

助手：我先帮你检查实际下载速度和连接情况。

吱吱老师提醒你：千兆宽带通常指 1000 Mbps，换算后理论速度约为 125 MB/s。和别人交流时可以说：“我的宽带是千兆的，想看看下载速度是否正常。”

2. 表达不够具体：意思对，但可以说得更清楚

你：帮我在网页上建个模型，可以旋转查看。

助手：我先了解你想展示的模型和交互方式，再安排实现。

吱吱老师提醒你：“网页建模”能让人理解你的大致想法。如果你希望用 Three.js 实现，可以更具体地说：“帮我用 Three.js 做一个可旋转查看的网页 3D 模型。”

“网页建模”不一定说错；如果还没决定用什么工具，助手不应替用户假定使用 Three.js。

3. 概念混淆：把两个相近的东西当成一回事

你：把 Mac Studio 的屏幕关掉，让它睡眠后继续下载文件。

助手：我会先检查电源设置，确认如何保持下载运行。

吱吱老师提醒你：关闭屏幕和系统睡眠是两回事。屏幕关闭时，电脑可以继续工作；进入系统睡眠后，下载通常会暂停。可以说：“关掉屏幕，但让电脑保持运行。”

4. 信息缺失：任务能理解，但需要补充条件

你：帮我装一个能在我显卡上运行的大模型。

助手：我先确认你的显卡型号、显存和用途，再选择适合的模型。

吱吱老师提醒你：选模型时，显卡型号和显存大小都会影响选择。向别人求助时可以补充：“我的显卡型号是……，显存是……，想用模型来……”

信息缺失不代表说错了；补充这些条件有助于别人更快理解需求。

5. 忽略前提：方案可能成立，但还需要确认

你：照片已经同步到云端了，帮我把电脑上的全部删掉，给电脑腾空间。

吱吱老师提醒你：有些云同步服务会把删除操作同步到其他设备和云端。建议先确认服务的删除规则，并检查有没有独立备份，再决定怎么清理。

助手：我先确认使用的是哪种同步服务和清理方式。

可能造成数据丢失等后果时，提醒应在相关操作之前给出。

DeepSeek Harness

本项目是 Harness bundle，为现有会话添加一小段静态行为指导，不创建独立后台服务、不保存聊天记录，也不触发额外模型调用。助手原有的模型提供商仍会按用户的配置处理聊天内容；插件不能保证模型每次都遵循指导。

本地开发测试：

npm test

安装到已有 Harness profile：

dsh plugin --profile desktop add github:jf143757-max/dsh-tech-companion

新会话中试问：“UDP 和 ASCII 是二选一吗？”和“帮我把文件改名”。卸载：

dsh plugin --profile desktop remove dsh-tech-companion

具体 profile 名与启动方式取决于你的 Harness 安装；详见 Harness 官方打包文档。

当前已在 DeepSeek Harness 0.2.1-rc.3 的真实 Cordis / SystemPrompt 运行时验证加载、提示词注册和卸载，并在隔离配置中验证本地包安装。完整对话效果取决于所选模型，遇到不确定问题仍应核对事实。

Hermes Agent

skills/tech-companion/SKILL.md 提供相同的对话指导。Hermes 的普通技能通常按需加载；要在每个新会话应用，需要用户显式配置 skills.auto_load，而不是假装安装技能后会自动覆盖每个对话。CLI 测试可以使用 hermes -s tech-companion chat -q '你的问题'。详见 Hermes 技能文档 和 自动加载说明。