feishu2md
v2.4.0
これは、Go 言語を使用して実装された、Feishu ドキュメントを Markdown ファイルとしてダウンロードするためのツールです。
こちらをご覧ください: ニーズと関心のある開発者を募集し、一緒に開発とメンテナンスについて話し合います。ご興味がございましたら、お問い合わせください。
「1 日 1 スキル | 私が開発したこの小さなツールは、Feishu ドキュメントを Markdown に簡単に変換するのに役立ちます。」
設定ファイルには APP ID と APP SECRET 情報を入力する必要があります。Feishu の公式ドキュメントを参照して取得してください。推奨設定は
Feishu 開発者バックエンドに入る
法人向け自作アプリ（個人版）を作成し、任意の情報を入力
(重要) 権限管理を開き、次の必要な権限を有効にします (以下のリンクをクリックして、API デバッグ コンソール -> 権限設定フィールドを参照できます)
ドキュメントの基本情報を取得、「ドキュメントの新しいバージョンを表示」権限docx:document:readonly
ドキュメントのすべてのブロックを取得します。「ドキュメントの新しいバージョンを表示」権限docx:document:readonly
資料のダウンロード、「クラウド ドキュメントの画像と添付ファイルのダウンロード」権限docs:document.media:download
フォルダー内のファイルのリストを取得します。「クラウド スペース内のすべてのファイルの表示、コメント、編集、管理」権限drive:file:readonly
ナレッジスペースノード情報の取得、「ナレッジベースの表示」権限wiki:wiki:readonly
資格情報と基本情報を開いて、アプリ ID とアプリ シークレットを取得します。
注: Feishu ドキュメントの古いバージョンのダウンロード ツールは今後メンテナンスされないことが決定されましたが、ブランチ v1_support は引き続き使用でき、対応するアーカイブは v1.4.0 です。
Go言語のクロスプラットフォーム機能により、主要なプラットフォームの実行ファイルがコンパイルされてReleaseでダウンロードでき、対応するプラットフォームのfeishu2md実行ファイルをPATHパスに置くことができます。
ヘルプドキュメントを確認してください
$ feishu2md -h 名前： feishu2md - feishu/larksuite ドキュメントをマークダウン ファイルにダウンロード 使用法： feishu2md [グローバル オプション] コマンド [コマンド オプション] [引数...] バージョン: v2-0e25fa5 コマンド: config 構成ファイルを読み取るか、指定されている場合はフィールドを設定します download, dl feishu/larksuiteドキュメントをマークダウンファイルにダウンロード help, h コマンドのリストまたは 1 つのコマンドのヘルプを表示します。グローバル オプション: --help、-h ヘルプを表示 (デフォルト: false) --version、-v バージョンを出力します (デフォルト: false) $ feishu2md config -h 名前： feishu2md config - 構成ファイルを読み取るか、指定されている場合はフィールドを設定します 使用法： feishu2md config [コマンドオプション] [引数...] オプション: --appId value OPEN API のアプリ ID を設定します。 --appSecret value OPEN API のアプリ シークレットを設定します。 --help、-h ヘルプを表示 (デフォルト: false) $ feishu2md dl -h 名前： feishu2md ダウンロード - feishu/larksuite ドキュメントをマークダウン ファイルにダウンロードします 使用法： feishu2md ダウンロード [コマンド オプション] <url>OPTIONS: --output value、-o value マークダウン ファイルの出力ディレクトリを指定します (デフォルト: "./")。 --dump OPEN API の json レスポンスをダンプします (デフォルト: false) --batch フォルダー内のすべてのドキュメントをダウンロードします (デフォルト: false) --wiki Wiki 内のすべてのドキュメントをダウンロードします (デフォルト: false)。 --help、-h ヘルプを表示 (デフォルト: false)
設定ファイルを生成する
ツールの構成ファイルはfeishu2md config --appId <your_id> --appSecret <your_secret>コマンドを通じて生成できます。
feishu2md configコマンドを使用すると、構成ファイルのパスと構成が成功したかどうかを確認できます。
その他の構成オプションについては、構成ファイルの変更を手動で開いてください。
単一のドキュメントをマークダウンとしてダウンロードする
feishu2md dl <your feishu docx url>から直接ダウンロードします。ドキュメントのリンクは、共有 > リンク共有をオンにする > インターネット上でリンクを取得した人が読むことができます > リンクをコピーすることで取得できます。
例：
$ feishu2md dl "https://domain.feishu.cn/docx/docxtoken"
フォルダー内のすべてのドキュメントを Markdown として一括ダウンロードする
この機能は現在、Docker バージョンをサポートしていません
feishu2md dl --batch <your feishu folder url>を通じて直接ダウンロードします。フォルダのリンクは、共有 > リンク共有をオンにする > インターネット上でリンクを取得した人が読むことができます > リンクをコピーすることで取得できます。
例：
$ feishu2md dl --batch -o 出力ディレクトリ "https://domain.feishu.cn/drive/folder/foldertoken"
ナレッジベースのすべてのドキュメントをマークダウンとしてバッチダウンロードする
feishu2md dl --wiki <your feishu wiki setting url>を通じて直接ダウンロードします。wiki 設定リンクは、ナレッジ ベースの設定を開くことで取得できます。
例：
$ feishu2md dl --wiki -o 出力ディレクトリ "https://domain.feishu.cn/wiki/settings/123456789101112"
Docker イメージ: https://hub.docker.com/r/wwwsine/feishu2md
Docker コマンド: docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID=<your id> -e FEISHU_APP_SECRET=<your secret> -e GIN_MODE=release wwwsine/feishu2md
Docker Compose:
# docker-compose.ymlversion: '3'services: feishu2md:image: wwwsine/feishu2mdenvironment: FEISHU_APP_ID: <あなたの ID> FEISHU_APP_SECRET: <あなたのシークレット> GIN_MODE: releaseports: - 「8080:8080」
サービスを開始しますdocker compose up -d
次に、https://127.0.0.1:8080 にアクセスし、ドキュメントのリンクを貼り付けます。ドキュメントのリンクは、 [共有] > [リンクの共有を有効にする] > [リンクをコピー]で取得できます。
私は個人用のテスト API トークンを使用して、不安定なバージョンをレンダリング プラットフォームにデプロイしました。このバージョンでは、ドキュメントや画像はコンテナに保存されず、圧縮されたパッケージ ファイルが HTTP 経由でメモリから直接返されますが、レンダリング プラットフォームのログは返されます。一部の HTTP 情報をログに記録する場合があります。
現在のバージョンは、プライバシーを気にしないユーザー、またはプライバシーを設定するのが面倒なユーザーによる一時的な使用のみを目的としており、自分のトークン権限設定に問題があるかどうかをテストして比較するためにも使用できます。レンダー プラットフォームは無料クォータを使用しており、高可用性は 512M しかありません。信頼チェーンは完全にオープン ソース コードに依存しているため、ご自身の判断で使用してください。
https://feishu2md.onrender.com/ にアクセスし、ドキュメントのリンクを貼り付けます。ドキュメントのリンクは、[共有] > [リンク共有を有効にする] > [リンクをコピー]で取得できます。
カイロック/ヒバリ
chyroc/lark_docs_md
