
拾文 · Shiwen DSH
把日常的想法和资料留下来,慢慢整理成自己的积累。
拾文是一个基于 DeepSeek Harness(DSH) 的个人 AI 工作台。你可以写日记、记下想法、收藏资料,与 Agent 讨论,再从这些记录中回顾生活、整理思路、创作文章。资料库保存在自己的电脑上。
中文 | English
为什么做 · 能做什么 · 开始使用 · 数据与隐私 · 参与开发
可下载 Android 0.1.2、Linux 0.1.9、Windows 0.1.9 预览版,以及 DSH 插件 0.2.0-dev.4。项目采用 MIT 许可证。Android 0.1.2 修复正文图片重新渲染后持续显示加载中的问题;Windows 旧版已验证虚拟机安装与服务启停,新版完整图形界面仍待验收。macOS 未提供本项目安装包。
本次更新: 改进 Android Markdown 显示,支持图片插入、系统分享、外部传入、跨库复制、同步和备份恢复。图片同步需要同步更新服务端;旧服务会提示升级,不会静默丢弃图片。
为什么做拾文
做拾文,最初是想给自己找一个更顺手的记录工具。
很多笔记和知识管理工具功能很丰富,但对我来说,上手和维护也需要投入不少精力。我希望记录这件事能简单一点:想到什么就写下来,看到有价值的文章就存起来,有问题就和 AI 聊一聊,不必先设计好一整套分类、模板和工作流。
另一个原因是,有些内容我更愿意留在自己的电脑上。日记、尚未成形的想法、工作中的记录,都是很个人的东西。我希望自己掌握它们的存储位置,也不想为了整理这些资料,就把整个资料库托管到云端。
于是有了拾文。它以 DSH 为底座,把对话、记录、资料整理和创作放在同一个工作台里。我希望 AI 能帮我保存想法、找回过去的记录、梳理积累的素材,并在需要时,把这些零散的内容逐渐整理成文章。
“拾文”这个名字,也来自这样的愿望:把日常里值得留下的片段拾起来,让它们慢慢成为自己的积累。
拾文将资料库保存在本机。使用云端 AI 模型时,对话及参与处理的相关资料仍会发送给所配置的模型服务商;本地存储不等于 AI 处理全程离线。
能做什么
下表描述当前源码;已发布安装包的功能以对应发布说明为准。
| 想做的事 | 拾文提供的能力 |
|---|---|
| 随手留下记录 | 保存日记、想法、自由书写和参考资料,支持 Markdown 编辑、可读预览和库内图片 |
| 和 AI 一起思考 | 使用 DSH 原生对话;从资料详情进入讨论,讨论中的 AI 内容也可保存为素材 |
| 整理已有资料 | 按类型筛选、搜索正文;Agent 可修改类型、作者来源、日期和内容,以及删除、恢复资料 |
| 回顾一段时间 | 按当日、近 7/14/30 天或自然月查看资料与写作统计;让 Agent 检索并阅读对应记录 |
| 从素材写成文章 | 创建文章、关联素材,获得发布前检查提示 |
| 接入其他 Agent | 通过 MCP、HTTP API、CLI 和配套 Skill 保存、查询和管理资料 |
当前源码中,素材和创作列表只展示标题与日期,搜索、筛选位于列表顶部;可以收起列表,让正文占满内容区。
列表和查询按内容日期倒序,同日按创建时间倒序,未知日期放在最后。个人书写、外部资料和 AI 内容分别标记;由 Agent 代存,不会因此一律变成 AI 创作。
内置的“皮皮”是一个可编辑的助理角色,你可以修改身份与交流方式。Agent 提出的长期记忆须经确认后才使用。
可以怎样使用
你可以直接在素材页记录,也可以在配置好模型后,让 Agent 帮忙。例如:
“把我刚才这段原话存成今天的日记,标记为自己书写。”
“查一下上个月的日记和想法,读完后帮我回顾发生了什么,并告诉我依据哪些记录。”
“围绕这个选题找一些已有素材,先和我讨论提纲,再整理成文章草稿。”
这些是使用方式示例,实际结果取决于资料、模型和工具配置。发布前检查提供提示,事实、引用和私人信息仍需人工核对。
开始使用
Web 插件预览版
已有 DSH 0.2.2-alpha.3 / Node.js >=24.9 的用户,可直接下载 拾文插件包(.tgz),无需克隆源码。安装命令、校验文件和已知限制见 发布说明。
直接在本仓库运行,不需要 Electron 或 DSH 上游源码:
npm ci
npm run start:web -- --no-open
打开终端打印的登录地址;默认使用独立的 shiwen-web profile。也可运行 npm run package:plugin,把预构建 tgz 安装进现有 DSH Web。模型和原生对话由 DSH 提供,拾文通过插件加入资料库、整理、回顾和创作。
PC 客户端与独立服务(v0.1.9)
Linux 安装包同时包含客户端、独立服务与 Node 运行环境,无需额外安装 Node。资料保存在运行服务的电脑上:本机模式使用这台电脑的资料库,远端模式访问另一台电脑的资料库,不会自动复制或合并资料。
| 连接方式 | 启动与退出行为 |
|---|---|
| 本机服务 | 已运行就连接,未运行则自动启动;退出时选择保留服务、停止服务或取消 |
| 局域网 / 其他电脑 | 输入服务地址和访问密码;退出只关闭客户端,不停止远端服务 |
首次使用:
- 在保存资料的电脑上打开拾文,选择“本机服务”;需要手机或其他电脑访问时,勾选允许局域网访问。
- 在首次打开的页面设置访问密码,至少 10 个字符。它是工作台的访问密码,与模型服务的 API Key 不同。
- 其他电脑的客户端选择“局域网 / 其他电脑”,填写服务地址和密码;电脑、手机浏览器直接打开普通地址,例如
http://192.168.1.20:3080/,按页面提示登录,地址无需附带 token。 - 可勾选“记住此设备”,登录凭据有效期 30 天;不勾选则使用浏览器会话 Cookie,服务端有效期最多 12 小时。客户端连接配置不保存密码。
“设置 → 拾文资料 → 管理访问密码与设备”可修改密码、撤销设备或退出登录,“外部接入”也提供管理入口。修改密码需要当前密码,会让其他设备退出;撤销设备也会断开其已建立的实时连接。服务在相同协议、地址和端口重启后,未过期的设备凭据仍有效。所有已登录设备共用这一个人工作台,目前没有多用户角色隔离。
本地安装或升级: 先完成 桌面构建前置条件,然后在仓库目录打包。安装前退出客户端,并停止仍在运行的独立服务;仅关闭客户端但选择“保留服务”不足以完成升级准备。
npm run package:linux
# 退出客户端并停止旧服务后安装
sudo apt install ./release/shiwen-dsh_0.1.9_amd64.deb
源码启动的服务可在同一数据根目录下执行 npm run server:stop 停止;安装包也提供无需系统 Node 的管理命令,见 独立服务说明。升级后重新启动本机服务。无需自行构建时,可直接下载下方的 v0.1.9 安装包。
只运行独立服务,让浏览器访问
需要 Node.js >=24.9。在服务电脑的仓库目录执行,启动前先退出占用同一资料库的旧桌面程序或旧服务:
npm ci
npm run server:prepare
npm run server:start -- --lan
npm run server:url
在服务电脑打开 server:url 输出的一次性管理链接,设置首次密码。该链接有效期 5 分钟,只能使用一次,不要分享给其他设备。随后通过 npm run server:status 查看普通服务地址,其他设备用该地址和密码登录。不带 --lan 时仅允许本机访问;多网卡时使用 --host <局域网 IP> 明确指定地址。
独立服务可在没有桌面窗口的情况下运行。局域网访问需要设备之间可以互通,手机不能用 127.0.0.1 连接电脑。HTTP 仅用于可信局域网;HTTPS 配置、启停命令和数据目录见 独立服务说明。
已发布的 Linux 桌面版
下载 Linux x64 安装包(.deb)。这是预览版,适合愿意反馈问题的用户;Windows 安装包见下方。校验文件与已知限制见 发布说明。
完整退出拾文并停止仍在运行的独立服务,再在下载目录安装或升级:
sudo apt install ./shiwen-dsh_0.1.9_amd64.deb
从应用菜单打开「拾文」,或运行 shiwen-dsh。安装包包含 Electron、Node、DSH 和拾文插件,无需另外安装 Node 或保留源码目录。当前桌面验证环境为 Ubuntu 26.04 x64,其他发行版仍需验证。
先在素材页新建一条记录即可开始使用。使用 AI 对话前,需要完成 DSH 的模型与凭据配置;安装包不附带模型服务账号或 API Key。
Android 正式签名安装包
下载 Android 0.1.2 APK,支持 Android 9 及以上。升级直接覆盖安装,保留现有资料与配置;不要先卸载有未同步资料的应用。该 APK 使用发布签名,不是 .probe 调试应用;两个应用的数据目录不同。
手机拥有完整本地资料库,断网可以记录和编辑。设置中添加服务地址、访问密码,为节点命名;连接电脑所在局域网后,可手动同步或启用自动同步。手机模型与密钥单独配置,不随资料同步。支持范围、校验文件和已知限制见 发布说明 与 Android 使用说明。
Windows x64 预览安装包
下载 Windows 0.1.9 安装程序。包含客户端、独立服务、Node 和 Microsoft Visual C++ x64 运行库,安装需要管理员权限。安装程序尚未进行代码签名,Windows 可能显示未知发布者。
此前的 0.1.7 已在 Windows 10 虚拟机验证安装、测试资料库路径迁移和服务启停;0.1.9 的完整图形界面及其他 Windows 版本仍待验证。升级前退出客户端并停止本机独立服务。详情见 Windows 发布说明。
Web 与桌面共用资料
v0.1.9 的桌面客户端、电脑浏览器和手机浏览器连接同一个独立服务、同一份资料与会话。在“外部接入 → 浏览器访问”查看或复制服务地址,以访问密码登录即可,无需重新导入资料。退出本机客户端时选择保留服务,浏览器仍可继续使用;服务电脑需要保持开机且网络可达。
切换页面或点击“刷新”读取另一端保存的记录,重新打开记录读取正文。未保存草稿保留在各自窗口;同时编辑同一条记录时,旧版本保存会被拒绝。Android 原生客户端另有独立本地资料库和协调服务同步实现;它不是把桌面/Web 自动变成离线副本,也不表示所有平台可点对点同步。Android 尚未发布 APK,当前代码和验收边界见 交付状态。
已发布的 v0.1.5 桌面版仍使用旧方式:从“外部接入 → 浏览器访问”复制完整登录链接,仅供本机浏览器访问,且需要保持桌面程序运行。独立安装到原生 DSH 的 Web 插件继续使用宿主认证;npm run start:web 创建的 shiwen-web profile 也不会自动接入现有桌面资料库。见 Web 插件说明。
已有旧版资料
当前源码和 v0.1.9 打开「设置 → 拾文资料 → 导入旧版资料」,填写运行服务的电脑上的旧拾文数据库文件路径,预览后导入;已发布的 v0.1.5 入口仍在「素材」。目标资料库必须为空;源库只读,历史消息保留为归档,不转换成 DSH 原生会话。
本仓库只维护基于 DSH 的拾文,旧版独立客户端不再在这里更新。
想让其他 Agent 操作拾文
打开「外部接入」(空间不足时位于侧栏「更多」),创建客户端凭据、选择权限,再把生成的 MCP 配置填入外部 Agent。默认仅允许新增资料,权限可分别授予,凭据可撤销。使用时保持提供资料库的 Host 或独立服务运行。外部 Agent 接口只监听服务电脑的回环地址,不因开启局域网 Web 访问而对局域网开放。
接入说明 · English guide · 配套 Skill
数据与隐私
Web 插件默认保存在 $DSH_HOME/shiwen/<profile>/library,DSH_HOME 默认 ~/.dsh。数据位于运行 DSH 的电脑;不同 profile 默认隔离。
Linux 本机桌面与独立服务共用的数据根目录是 ${XDG_DATA_HOME:-~/.local/share}/shiwen-dsh:
| 子目录 | 保存内容 |
|---|---|
library/ |
拾文资料数据库,包含记录、正文和来源信息 |
dsh/ |
DSH 会话、配置与技能 |
desktop/ |
桌面连接偏好与客户端会话数据 |
server/ |
v0.1.9 独立服务状态、日志与密码认证数据库 |
workspaces/ |
工作文件 |
远端连接时,资料仍留在服务电脑上。访问密码以随机盐和 scrypt 派生结果保存,设备凭据只在服务端保存摘要;本机管理链接和设备凭据都应作为私密信息保管。
Markdown 内容存放在本地资料数据库中,并非每条记录都是独立的 .md 文件。安装包不预装个人资料、会话或凭据;卸载、重装软件不会自动清除用户资料。
你可以通过 SHIWEN_ROOT_DIR 指定数据目录。开发版与安装版默认使用同一目录,开发测试时应使用独立临时目录。
数据是否发送到外部,取决于模型和工具的使用:云端模型会接收请求中的对话上下文和工具返回的相关资料,外部 MCP 或其他服务会接收调用它们时提供的参数。使用前应根据资料性质选择配置。停用记忆会影响后续上下文装配,之前的会话和摘要可能仍包含原内容。
当前进展
| 状态 | 范围 |
|---|---|
| 已完成本机验收 | Linux 桌面启动、本机服务启动与复用、资料读写/筛选/排序、删除恢复、重启持久化、外部 MCP/HTTP/CLI;密码登录、设备撤销与实时连接断开;浏览器窄屏与中英文登录页面 |
| 仍需验证 | 更多机器上的系统安装/升级、Windows 完整界面与 macOS、真实模型端到端流程,以及不同模型供应商和外部 Agent 配置 |
| 桌面尚待完成 | 自动更新、关闭窗口最小化到托盘的可配置行为、文章导出与版本界面 |
| Android 已发布 | 完整本地资料库、对话/手机 Agent、多节点资料同步、文件备份与 DSH 管理页;现用设备覆盖升级、素材保存与同步已验收,其他系统与后台场景仍需验证。范围见 Android 交付状态 |
现在可构建并通过 DSH CLI 安装独立组合包,已有 Linux 桌面版继续共用业务模块。组合包通过 GitHub Release 提供,尚未发布 npm;dsh-plugin 话题也不代表官方收录。详见 插件架构与发布状态。
参与开发
需要 Node.js >=24.9、npm 和 Git。在克隆后的仓库目录中,可以先构建与测试拾文插件:
npm ci
npm run build
npm test
npm run check:source
测试使用临时资料,不调用付费模型;HTTP/MCP 测试需要本机回环连接。上述命令不会启动完整桌面端。
桌面开发还需固定的 DSH 上游、Linux 补丁和原生运行资源。准备方法、目录结构相关说明和验收命令见 开发与构建说明;上游版本与补丁记录在 upstream.lock.json,业务模块位于 plugins/。
欢迎通过 Issues 提交问题与建议。贡献代码前请阅读 贡献指南。
更新记录 · 扩展工具与 Skills · 开发说明
致谢与许可证
感谢 DeepSeek Harness 提供原生对话、会话管理和 Agent 执行底座,让拾文可以专注于记录、资料整理和创作。
No comments yet. Be the first to write one.