@tezign/dsh-quote-sheet-generator

Readme

# @tezign/dsh-quote-sheet-generator

> Generate structured **Feishu / Lark spreadsheet quotations** with automatic cost & profit calculation — as a one-command-install skill for **DeepSeek Harness (dsh)**.
>
> 飞书电子表格**报价单生成器**：自动计算成本、人力投入、利润率、付款节点，包含项目明细、资源分配、ROI 预估等工作表。DeepSeek Harness 一键安装的技能插件。

[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-blue)](https://github.com/topics/dsh-plugin)
[![npm](https://img.shields.io/npm/v/@tezign/dsh-quote-sheet-generator)](https://www.npmjs.com/package/@tezign/dsh-quote-sheet-generator)
[![Downloads](https://img.shields.io/npm/dm/@tezign/dsh-quote-sheet-generator)](https://www.npmjs.com/package/@tezign/dsh-quote-sheet-generator)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

---

## 这是什么 / What is this

一个 **DeepSeek Harness (dsh) 插件包（bundle）**：安装后，`lark-quote-sheet-generator` 技能自动注册进你的 AI 技能目录，AI 就能帮你生成结构化的飞书电子表格报价单——含报价总览、项目明细、人力资源、成本分解、ROI 预估 5 个工作表，全部公式自动计算。

It is a **dsh plugin bundle**: after install, the `lark-quote-sheet-generator` skill is auto-registered, so your AI agent can generate fully-formula-driven Feishu/Lark spreadsheet quotations (overview, items, headcount, cost breakdown, ROI — 5 sheets).

## 安装 / Install

需要已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）与 [pnpm](https://pnpm.io/)。

```sh
# 在你的 web profile 中安装本插件
dsh plugin --profile web add @tezign/dsh-quote-sheet-generator

# 重启 dsh web 后生效（技能自动出现在 AI 技能目录）
```

## 前置依赖 / Prerequisites

本插件本身零依赖，但生成报价单需要飞书能力，请确保你的环境中已有：

1. **lark-cli** — 飞书命令行工具（全部表格操作经由它执行）
2. **lark-cli 认证** — `lark-cli auth login`，用户身份或机器人身份均可，需 `spreadsheet` 权限域
3. 其他 lark-cli 生态技能（如 `lark-sheets`）可另行安装，非必需

## 使用方法 / Usage

装好后直接对 AI 说：

> "帮我做一份报价单，项目是 AI 内容平台，客户某某集团，周期 8 周，预期报价 68 万"

AI 会引导你补齐必填信息（项目名称 / 客户 / 周期 / 预期报价 / 团队规模）与可选参数（利润率目标、付款比例、特殊说明），然后自动生成 5 个工作表并应用格式。

## 安全与隐私 / Security & Privacy

- **包内无任何密钥**：本插件不包含、不读取、不写入任何 API Key / token / 凭据（已通过发布前审计，见 [AUDIT.md](AUDIT.md)）。
- **凭据留在本机**：飞书认证由你本机的 `lark-cli` 管理（环境变量 / `$DSH_HOME/.credentials.yaml` / `.env`），插件与技能代码不接触密钥。
- **数据不出你的账号**：所有表格操作发生在你授权登录的飞书账号内，本插件不收集、不上传任何数据。

## 开发 / Development

```sh
git clone https://github.com/tezign/dsh-quote-sheet-generator
cd dsh-quote-sheet-generator
# 本地调试：用 --patch 覆盖层直接加载本目录，无需发布
dsh --profile web --patch ./cordis.patch.yml
```

## 发布 / Publishing

```sh
npm login          # 或 npm publish --access public
npm publish
```

发布后请给 GitHub 仓库打上 **`dsh-plugin`** topic，让其他用户可以按该标签发现你的插件。

## License

MIT © Tezign Technology