dsh-feishu-writer：让 DeepSeek Harness 的 Agent 把产出写进飞书

前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」，开发者可以通过插件为智能体扩展能力。目前社区已有不少「读」飞书和「聊」飞书的插件，但「写」的环节仍然空白：Agent 生成的分析报告、整理的数据、沉淀的知识库，往往只能停留在对话上下文或本地文件，无法直接同步到飞书文档、表格或知识库中。dsh-feishu-writer 插件填补了这一空白，让 Agent 的产出可以直接写入飞书。

插件简介¶

dsh-feishu-writer 是一个 DeepSeek Harness 插件，由维护者 zhangjingyuan177-hue 开发。它为 DSH 的 Agent 注册了 4 个工具，分别用于创建飞书文档、电子表格、多维表格（Bitable）和知识库空间。这些工具通过调用飞书官方 CLI (lark-cli) 来操作飞书 OpenAPI，无需手动登录或存储凭据。

核心功能¶

插件注册了 4 个面向模型的工具：

工具	能力	返回值
`feishu_write_doc`	创建飞书文档，内容为 Markdown	`{"document_id":"...","url":"..."}`
`feishu_write_sheet`	创建电子表格，可预填二维数组数据	sheet 信息 + 写入范围
`feishu_write_bitable`	在工作区中创建 BitTable（多维表格）	`{"app_token":"...","url":"..."}`
`feishu_write_wiki`	创建知识库空间	`{"space_id":"...","name":"..."}`

安装与启用¶

安装前需要先安装飞书官方 CLI 并完成登录。

1. 安装飞书 CLI¶

npx @larksuite/cli@latest install

2. 登录授权¶

lark-cli auth login --recommend

该命令会打开浏览器页面进行 OAuth 授权。

3. 安装插件¶

dsh plugin add <owner>/dsh-feishu-writer

插件安装后会自动注册上述 4 个工具，Agent 即可调用。

典型用法¶

创建周报文档¶

agent → feishu_write_doc(title="第42周周报", content="# 本周进展\n- 完成 RAG 检索优化\n- 上线评测闭环")
agent → {"document_id":"...","url":"https://xxx.feishu.cn/docx/..."}

创建电子表格并填充数据¶

agent → feishu_write_sheet(title="季度数据", values='[["月份","营收"],["Q1",120],["Q2",150]]')

创建知识库空间¶

agent → feishu_write_wiki(name="AI 应用开发笔记", description="RAG/Agent/评测 实战沉淀")

创建 BitTable（需要工作区 token）¶

在飞书多维表格的 URL 中获取工作区 token（形如 base/workspace/<token>）：

agent → feishu_write_bitable(name="项目看板", workspaceToken="GUs9soB...")

适用场景与注意¶

该插件适合需要让 Agent 将产出直接沉淀到飞书场景的开发者，例如自动生成周报、整理调研数据、搭建知识库等。

使用时需要注意以下几点：

插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT）。
插件通过调用 lark-cli 与飞书交互，不使用 shell 解释器，参数直接传递给 spawn，避免注入风险。
工具仅支持创建对象，不支持删除、共享或修改已有内容（写-only scope）。
知识库空间默认为私有，分享前需手动检查权限。
Windows 环境下插件会按优先级解析 LARK_CLI_BIN 环境变量或 PATH 中的 lark-cli.exe，解析失败时会返回明确的修复提示。
插件属于 R2 级能力（外部进程 + 网络 + 凭据），完全复用 lark-cli 的 OAuth 凭据（存于系统 keychain），不读取、不存储、不转发任何 token。

生态背景¶

DeepSeek Harness 的插件生态由社区共建，SkillHub 是独立的插件目录站点，与 DeepSeek / 幻方无官方从属关系。本插件遵循 MIT 许可证，使用飞书 Open Platform 的 API（通过 lark-cli）。

插件目录：https://www.skillhub.cn/plugins/zhangjingyuan177-hue/dsh-feishu-writer
GitHub：https://github.com/zhangjingyuan177-hue/dsh-feishu-writer