Skip to content

Commit a71cbe6

Browse files
committed
docs(feishu-bridge): separate this Plugin from the built-in Feishu support
## Problem The title says "drive MiniMax Code from a Lark/Feishu conversation", and MiniMax Code already ships two things that answer to the name Feishu. A reader landing on this PR, and a reviewer triaging it, both have to work out on their own whether this is a duplicate. That answer belongs on the page, not in a discussion thread. The two existing pieces, and what each one actually does: - `lark-tools`, the built-in Skill: mcode -> Feishu. Office work, reading and writing documents, calendar, Base, mail, approvals. It does not run a task on the user's machine. - The Feishu channel in the desktop runtime, under packages/local-runtime/src/ channels/: Feishu -> agent. The same direction as this Plugin, but it needs the Mavis desktop app running and a Feishu app bound to it, and it answers with interactive cards, including a permission card that approves a pending tool call by tapping. Neither one is this Plugin, and none of the three replaces another. Saying so was missing, not because it was contentious but because nothing on the page drew the line. ## Changes The README gains a section, "How this differs from the built-in Feishu support", directly after "What you get". It carries a three-row table of the three implementations and their directions, what each is for, why the built-in channel is the better choice for someone already working in the desktop app, and the case this Plugin covers instead: a headless machine with mcode and lark-cli on PATH and nothing else. It also states the cost rather than only the benefit. This Plugin edits plain text messages instead of sending cards, and it runs with `--permission full` because there is no in-chat prompt to tap, linked to the Security model section that already explains what that exposure means. Both SKILL.md copies gain the same distinction as a blockquote at the top of "Before starting anything", so the agent reads it before setting a bridge up rather than after a user reports that the official Skill already does this. It carries the instruction not to present this Plugin as a replacement for `lark-tools`. ## Validation node scripts/validate.mjs -> Validated 29 hosted Plugins and all examples. node scripts/mcode-feishu-bridge.test.mjs -> 84 passed, 0 failed, 0 skipped Both match the previous commit's baseline, which is what a documentation change should produce. ## Test evidence There is no new runtime behaviour to break, so the checks that matter here are the ones that could have silently falsified a claim the Plugin makes about its own packaging: - Both SKILL.md copies are still byte-identical. Each file was edited separately and the comparison is by hash afterwards, so the check does not pass merely because one file was copied over the other: 9D58DA024923420C0ED515F4B57A7F2BFE6B5E65FE226441C163BB6EADB33A87 for both. - All three edited files are still LF with no BOM, matching the Plugin-local .gitattributes, verified at byte level rather than by eye. - The `#security-model` anchor the new section links to resolves; "Security model" is a real heading in this README, not an aspirational one. ## Design compliance - Documentation only. No code, manifest, or test file is touched: 47 inserted lines across three files, zero deletions. - Both runtime layouts still ship byte-identical Skill copies. - No claim about the official implementations goes beyond what is observable: the Skill list as the product's own plugin panel enumerates it, and the direction and host implied by the file names under packages/local-runtime/src/channels/. - No credentials, endpoints, or host paths introduced.
1 parent e092353 commit a71cbe6

3 files changed

Lines changed: 47 additions & 0 deletions

File tree

‎plugins/antianqi/mcode-feishu-bridge/README.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,37 @@ conversation stays readable and nothing is duplicated.
6969
- **Readable while running.** The log is written by the bridge itself, so you can
7070
read it without the file being locked.
7171
72+
## How this differs from the built-in Feishu support
73+
74+
MiniMax Code ships Feishu support in two places already, and neither one is this
75+
Plugin. This one sends messages in the opposite direction, against a local mcode
76+
CLI rather than the desktop runtime.
77+
78+
| | direction | what it is for |
79+
|---|---|---|
80+
| `lark-tools` (built-in Skill) | mcode → Feishu | office work: read and write docs, calendar, Base, mail, approvals |
81+
| Feishu channel (local-runtime) | Feishu → agent | driving the Mavis desktop runtime through a bound Feishu app |
82+
| **This Plugin** | **Feishu → mcode** | **driving a local mcode CLI install** |
83+
84+
The first is not a remote control. Ask it to summarise this week's meeting notes
85+
and it does that inside Feishu; it does not run a task on your machine.
86+
87+
The second has the same shape as this Plugin but a different host. It lives in the
88+
Mavis desktop runtime, so it needs the desktop app running and a Feishu app bound
89+
to it, and it answers with interactive cards — including a permission card that
90+
approves a pending tool call by tapping. Prefer it if the desktop app is already
91+
your working environment.
92+
93+
This Plugin covers the remaining case: a headless machine with `mcode` and
94+
`lark-cli` on `PATH` and nothing else. It is a plain polling process, so any
95+
supervisor you already use can restart it, and there is nothing to install. In
96+
exchange it edits plain text messages instead of sending cards, and it runs with
97+
`--permission full` because there is no in-chat approval prompt to tap — see
98+
[Security model](#security-model).
99+
100+
The two do not conflict. Installing this Plugin neither requires nor disables the
101+
built-in channel, and both can run at once.
102+
72103
## Setup
73104
74105
The Plugin is Skill-only: no `mcp.json`, no `package.json`, no install step. But it

‎plugins/antianqi/mcode-feishu-bridge/skills/SKILL.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,14 @@ twelve tool calls still produces one bubble, not twelve.
2121

2222
## Before starting anything
2323

24+
> **Do not confuse this with the built-in `lark-tools` Skill.** `lark-tools` drives
25+
> Feishu *from* mcode — documents, calendar, Base, mail, approvals. This Plugin is
26+
> the opposite direction: a Feishu message becomes a local `mcode` turn. The
27+
> desktop runtime also has a Feishu channel, which is the same reverse direction but
28+
> needs the Mavis desktop app running and a Feishu app bound to it. Never present
29+
> this Plugin as a replacement for `lark-tools`; they do different jobs and can run
30+
> side by side.
31+
2432
The bridge has **no credentials of its own**. It uses `lark-cli`, which must already
2533
be configured for the user. Check first:
2634

‎plugins/antianqi/mcode-feishu-bridge/skills/mcode-feishu-bridge/SKILL.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,14 @@ twelve tool calls still produces one bubble, not twelve.
2121

2222
## Before starting anything
2323

24+
> **Do not confuse this with the built-in `lark-tools` Skill.** `lark-tools` drives
25+
> Feishu *from* mcode — documents, calendar, Base, mail, approvals. This Plugin is
26+
> the opposite direction: a Feishu message becomes a local `mcode` turn. The
27+
> desktop runtime also has a Feishu channel, which is the same reverse direction but
28+
> needs the Mavis desktop app running and a Feishu app bound to it. Never present
29+
> this Plugin as a replacement for `lark-tools`; they do different jobs and can run
30+
> side by side.
31+
2432
The bridge has **no credentials of its own**. It uses `lark-cli`, which must already
2533
be configured for the user. Check first:
2634

0 commit comments

Comments
 (0)