DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

22-ai-00 /

22-ai-00/dsh-enhanced

Topic repository only

借助dsh实现的一款自助成长的个人助理

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@5f960f16

文鳐 Ray icon

dsh-enhanced · 文鳐 Ray

文鳐 Ray logo

npm license node status

在本机运行的个人 AI 助手,通过 Web 或飞书聊天、处理任务、积累记忆,也可接入你自己的模型。基于 DeepSeek Harness。

助手名叫 文鳐(英文 Ray,小名小鳐)。文鳐出自《山海经》,是鱼身有翼、夜间飞行的祥瑞之鱼; 定位是突破型、创造力型助手,口号「小鳐小鳐,游而化飞」。包名与插件 id 仍沿用 dsh-enhanced / @dsh-enhanced/*。

项目希望让助手从日常使用和纠正中持续改进。目前是实验版,完整的自动改进闭环仍在验证中。 已支持的能力与限制见当前状态。

架构一览

每个能力都是可独立安装的 Cordis 插件;下图是主要引用关系(箭头表示运行时依赖或数据流向,虚线表示管理/凭据关系):

flowchart TB
  subgraph ingress["💬 渠道入口"]
    LK["lark-channel<br/>飞书长连接"]
    WEB["assistant-web-owner<br/>原生 Web owner"]
    CON["owner-console<br/>文鳐左栏控制台"]
  end
  subgraph core["🔐 持久消息与授权"]
    DL["assistant-delivery<br/>inbox/outbox · 配对 · 重试"]
    POL["assistant-policy<br/>默认拒绝 · 硬预算 · 审批"]
    AUTO["assistant-automations<br/>冷启动可恢复调度"]
  end
  subgraph task["🧩 持久任务与验收"]
    WI["assistant-work-items<br/>持久工作项 · 跟进 · 准入"]
    GO["assistant-goals<br/>原生目标 · 事件等待"]
    VER["assistant-verifier<br/>独立验收 · 证书"]
  end
  subgraph learn["🌱 学习与自我成长"]
    MEM["personal-memory"]
    ML["assistant-memory-learning"]
    GR["assistant-growth-driver<br/>技能 / 工作流 / 插件候选"]
    CP["plugin-control-plane<br/>隔离验证 · 采用 · 回滚"]
    ISO["assistant-isolation<br/>Linux/沙箱执行"]
    SK["assistant-skills"]
    EV["assistant-evolution"]
  end
  subgraph aware["🎯 评测 / 主动 / 事件"]
    EVA["assistant-evaluation<br/>结果与注意力账本"]
    PRO["assistant-proactive"]
    ET["event-triggers"]
    HB["assistant-heartbeat"]
  end
  subgraph ops["🛡 安全与运维"]
    KC["credentials-keychain"]
    HEA["assistant-health"]
    REC["assistant-recovery"]
  end

  LK --> DL
  WEB --> DL
  CON -.-> LK
  CON -.-> CP
  DL --> POL
  DL --> AUTO
  KC -.-> LK
  KC -.-> POL
  AUTO --> WI
  AUTO --> GO
  WI --> VER
  GO --> VER
  WI --> ML
  ML --> MEM
  DL --> GR
  GR --> CP
  GR --> SK
  GR --> EV
  CP --> ISO
  CP --> VER
  DL --> EVA
  WI --> EVA
  GO --> EVA
  EVA --> PRO
  PRO --> GO
  ET --> WI
  ET --> GO
  HB --> AUTO
  HEA --> REC

完整包清单与各自边界见插件目录;共享库在 packages/*,不自动启用。

开始使用

准备好 Node.js 24 LTS、飞书账号,以及一个可用模型(已登录的 TraeX 或模型服务的 API Key)。也支持 Node.js 22.19 及以上的 22.x,以及 24 以上版本。

  • macOS:原生运行,无需 Docker;已在 Apple Silicon Mac 验证,Intel Mac 尚未实机验收。
  • Linux:新安装的默认学习场景采用原生隔离,需要 bubblewrap、systemd 用户服务与已委派给当前用户的 cgroup v1 资源;当前拒绝 cgroup v2,旧部署不会自动迁移。详见安装准备。

暂不接飞书、只想先体验聊天,可直接看只用本机 Web。

1. 安装

在终端执行,无需下载源码:

npm install --global @dsh-enhanced/dsh-rsi-cli
dsh-rsi install

安装器先问一次是否“按推荐配置一路继续”,直接回车即可:默认使用 DeepSeek 官方模型,只在缺少 API Key 时隐藏输入一次(Key 存入 0600 的 .credentials.yaml,不出现在命令行和输出中)。提前 export DEEPSEEK_API_KEY=... 并加 --yes 时,模型步骤无需任何输入。检测到本机 TraeX 时会复用其登录;已有模型选择会保留。默认使用名为 web 的配置,首次使用保持默认即可。

新安装默认 Full access:助手可读写文件、访问网络、执行命令,不逐次请求批准。希望限制工作区外的写入并启用人工批准时,将第二条命令改为 dsh-rsi install --permission workspace-write。

2. 完成首次连接

  1. 打开终端给出的飞书授权链接,选择或创建机器人。
  2. 给机器人私聊发送终端显示的最新 DSH-CONNECT-… 验证码,以终端显示绑定成功为准;这一步不会收到聊天回复。
  3. 终端提示“最后一步”时,私聊发送 /model,选择模型并确认;安装器检测到这条私聊后自动继续,无需重新运行。之后只有已绑定的你可以操作和授权。

如果等待超时或终端提示缺少主人私聊会话,先完成第 3 步,再按安装排障继续。飞书消息接入与文档、邮件等业务权限是分开的,详见飞书接入。

3. 打开 Web

dsh-rsi web-url --profile web

在浏览器打开输出的地址,即可使用同一套本机服务。地址包含登录令牌,请勿公开分享。模型配置见添加与切换模型。

日常使用

直接在聊天里说“以后叫你柳神”“记住我喜欢简短回复”或“把这段内容保存到 Wiki”。明确要求的普通记忆和 Wiki 更新会保存并反馈结果,无需再点一次批准;助手自行提出的修改、删除或敏感记忆,以及你要求先确认的操作,仍会询问。

想做什么 命令
查看运行状态 dsh-rsi status
打开 Web dsh-rsi web-url --profile web
查看最近日志 dsh-rsi logs --profile web --lines 100
重启服务 dsh-rsi restart --profile web

浏览器关闭后,默认安装的服务仍会在后台运行。只升级命令本身用 dsh-rsi update。对于 Linux 冻结 owner/cohort,dsh-rsi update --all --yes 仅接纳原安装为 Docker 后端且满足严格前提的 Home;切到 native 时,创建/修订审查、修订回归与采用业务记录必须为空。原生 owner 的原地程序升级和非空创建历史迁移尚不支持;尚未建立 owner 的 Home 有独立维护入口。旧 CLI 须先单独运行一次 dsh-rsi update。普通安装的升级路径、恢复和 macOS 限制见 CLI 帮助。reinstall 会删除旧配置和历史后重新安装,请勿当作普通升级使用。

按需阅读

需要帮助 文档
首次安装、只用本机 Web、安装失败 安装指南
添加自己的模型、切换模型 模型配置
飞书绑定、权限、没有回复 飞书接入
升级、重装、卸载 命令参考
已支持什么、还有哪些限制 当前状态
选择额外插件 插件目录

参与开发

开发需要 Node.js(版本范围同上)和 pnpm 11.7.0。本地和远端只保留 dev、main;开发、版本准备、提交与推送使用 dev,仅在发布验证通过后合入 main。克隆仓库后:

pnpm install
pnpm check

pnpm check 包含校验、lint、构建、类型检查、测试和打包检查。新增插件见开发指南,包边界见架构说明,发布见发版指南。更多资料见文档索引。

MIT License

—/ 5

No ratings yet

Manifest verification required

Commit 5f960f16c2e1

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout