@timeryu/dsh-larklink 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @timeryu/dsh-larklink
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness 插件：多账号 lark-cli 路由 + 守卫式文档执行。
+
+## 工具
+
+| 工具 | 用途 |
+|---|---|
+| `larklink_resolve` | 文档 URL/裸 token → 绑定路由决策（或歧义候选+探测标注） |
+| `larklink_exec` | 守卫式执行文档域 lark-cli 命令（目标比对 / 确认指纹 / timeout-unknown） |
+| `larklink_bindings` | 无敏感绑定管理（adopt/list/health/pin）；add/auth/remove 走终端 |
+
+随插件内嵌注册 `larklink` SKILL（多账号防串号硬纪律、写操作纪律、确认流程）。
+
+## genui 面板（web）
+
+- 后端：`/larklink/bindings`（GET，`?live=1` 实时核验）、`/larklink/adopt`、`/larklink/health`（POST）——同源栅栏（origin/host + sec-fetch-site）
+- 前端：`lib/client.cjs` 注册 sidebar 右侧「Lark 绑定」页签——绑定状态灯（ready/needs_refresh/unauthorized/incomplete）、账号与品牌、文档 pin 列表、adopt/health 按钮，5s 自动刷新
+
+## 安装（DSH）
+
+```yaml
+# cordis.patch.yml
+- insert:
+    - id: larklink
+      name: "@timeryu/dsh-larklink"
+```
+
+前置：lark-cli 已安装并可执行（或设 `LARKLINK_LARK_CLI` 指向原生二进制）。
+
+## 设计
+
+见仓库 [docs/design.md](../../docs/design.md)（决议 Q1-Q10）与 [README](../../README.md)。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: larklink
+      # 必须与发布包名一致（Q9-③）；@ 开头需引号（YAML 保留字符）
+      name: "@timeryu/dsh-larklink"

package/lib/client.cjs

@@ -0,0 +1,11 @@
+window.__ModuleLoader__.load({
+	id: "@timeryu/dsh-larklink",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		"use strict";var b=Object.create;var p=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,S=Object.prototype.hasOwnProperty;var T=(e,n)=>{for(var i in n)p(e,i,{get:n[i],enumerable:!0})},m=(e,n,i,d)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of R(n))!S.call(e,r)&&r!==i&&p(e,r,{get:()=>n[r],enumerable:!(d=w(n,r))||d.enumerable});return e};var B=(e,n,i)=>(i=e!=null?b(x(e)):{},m(n||!e||!e.__esModule?p(i,"default",{value:e,enumerable:!0}):i,e)),P=e=>m(p({},"__esModule",{value:!0}),e);var C={};T(C,{apply:()=>O,inject:()=>I});module.exports=P(C);var t=B(require("react"),1),I=["slots"],f="@timeryu/dsh-larklink/bindings",D="larklink-bindings",g="Lark \u7ED1\u5B9A",h="sidebar.right.pane.tab",y="sidebar.right.pane.tab.title",v="/larklink",z={ready:"#22c55e",needs_refresh:"#f59e0b",unauthorized:"#ef4444",incomplete:"#9ca3af"};function k({size:e=16}){return t.default.createElement("svg",{width:e,height:e,viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:2,strokeLinecap:"round",strokeLinejoin:"round"},t.default.createElement("path",{d:"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"}),t.default.createElement("path",{d:"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"}))}function A(){let[e,n]=(0,t.useState)(null),[i,d]=(0,t.useState)(!1),[r,o]=(0,t.useState)(null),a=(0,t.useRef)(!0),l=(u=!1)=>{d(!0),fetch(`${v}/bindings${u?"?live=1":""}`).then(c=>c.json()).then(c=>{a.current&&(n(c),o(null))}).catch(c=>{a.current&&o(c.message)}).finally(()=>{a.current&&d(!1)})},s=u=>fetch(`${v}/${u}`,{method:"POST"}).then(c=>c.json()).then(c=>{a.current&&(n(c),o(null))}).catch(c=>{a.current&&o(c.message)});return(0,t.useEffect)(()=>{a.current=!0,l();let u=setInterval(()=>l(),5e3);return()=>{a.current=!1,clearInterval(u)}},[]),{data:e,loading:i,error:r,refresh:l,act:s}}function $({b:e}){let n=z[e.status]??"#9ca3af";return t.default.createElement("div",{style:{display:"flex",alignItems:"center",gap:8,padding:"6px 0",borderBottom:"1px solid rgba(128,128,128,.2)"}},t.default.createElement("span",{title:e.status,style:{width:8,height:8,borderRadius:999,background:n,flexShrink:0}}),t.default.createElement("div",{style:{minWidth:0,flex:1}},t.default.createElement("div",{style:{display:"flex",gap:6,alignItems:"baseline"}},t.default.createElement("strong",{style:{fontSize:12,overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap"}},e.profile),t.default.createElement("span",{style:{fontSize:10,opacity:.7}},e.brand),e.adopted?t.default.createElement("span",{style:{fontSize:10,opacity:.6}},"\u5BFC\u5165"):null),t.default.createElement("div",{style:{fontSize:10,opacity:.65,overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap"}},`${e.userName??"\uFF08\u672A\u767B\u5F55\u7528\u6237\uFF09"} \xB7 ${e.status}`)))}function j(){let{data:e,loading:n,error:i,refresh:d,act:r}=A(),[o,a]=(0,t.useState)(null),l=(s,u)=>{a(s),r(u).finally(()=>a(null))};return t.default.createElement("div",{style:{padding:10,fontSize:12,display:"flex",flexDirection:"column",gap:8}},t.default.createElement("div",{style:{display:"flex",gap:6}},E("\u540C\u6B65\u72B6\u6001(health)",()=>l("health","health"),o==="health"),E("\u5BFC\u5165 profile(adopt)",()=>l("adopt","adopt"),o==="adopt"),n?t.default.createElement("span",{style:{opacity:.6,alignSelf:"center"}},"\u2026"):null),i!==null?t.default.createElement("div",{style:{color:"#ef4444"}},`\u52A0\u8F7D\u5931\u8D25\uFF1A${i}\uFF08\u63D2\u4EF6\u540E\u7AEF\u672A\u8FD0\u884C\uFF1F\uFF09`):null,e?.warnings?.map((s,u)=>t.default.createElement("div",{key:u,style:{color:"#f59e0b",fontSize:11}},s)),e!==null&&e.bindings.length===0?t.default.createElement("div",{style:{opacity:.7}},"\u5C1A\u65E0\u7ED1\u5B9A\u3002\u70B9\u300C\u5BFC\u5165 profile(adopt)\u300D\u5BFC\u5165\u672C\u673A lark-cli profile\uFF0C\u6216\u5728\u7EC8\u7AEF\u8FD0\u884C larklink bindings add \u65B0\u589E\u8D26\u53F7\u3002"):null,e?.bindings.map(s=>t.default.createElement($,{key:s.profile,b:s})),e!==null&&e.pins.length>0?t.default.createElement("div",{style:{marginTop:4}},t.default.createElement("div",{style:{fontWeight:600,marginBottom:4}},`\u6587\u6863\u504F\u597D\uFF08pin\uFF0C${e.pins.length}\uFF09`),e.pins.map(s=>t.default.createElement("div",{key:s.token,style:{fontSize:10,opacity:.7,overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap"}},`${s.token.slice(0,14)}\u2026 \u2192 ${s.profile}`))):null,t.default.createElement("div",{style:{fontSize:10,opacity:.55,marginTop:4}},"add / auth\uFF08\u626B\u7801\uFF09/ remove \u9700\u5728\u7EC8\u7AEF\u6267\u884C\u2014\u2014\u5BC6\u94A5\u4E0D\u7ECF\u9762\u677F\u4E0E\u6A21\u578B\u3002"))}function E(e,n,i){return t.default.createElement("button",{onClick:n,disabled:i,style:{fontSize:11,padding:"4px 8px",borderRadius:6,cursor:i?"default":"pointer",border:"1px solid rgba(128,128,128,.4)",background:"transparent",opacity:i?.5:1}},e)}function L(){return t.default.createElement("span",{style:{display:"inline-flex",alignItems:"center",gap:6}},t.default.createElement(k,null),g)}function O(e){let n=[],i=r=>{typeof r=="function"&&n.push(r)},d=(r,o)=>{typeof o=="function"&&r.push(o)};return i(e.inject(["sidebarRight","sidebarRightTabs"],r=>{let o=r.get("sidebarRightTabs");if(o===null||typeof o.register!="function")return()=>{};let a=[];return d(a,r.slots.inject(h,()=>r.slots.inject(y,()=>(a.push((()=>{let l=o.register({id:f,kind:D,title:()=>g,guide:[{order:70,title:()=>g,description:()=>"lark \u591A\u8D26\u53F7\u7ED1\u5B9A\u72B6\u6001\u4E0E\u6587\u6863\u8DEF\u7531\u504F\u597D\uFF08adopt / health / pins\uFF09",icon:k}]});return typeof l=="function"?l:()=>{}})()),d(a,r.slots.register({name:h,key:f},()=>t.default.createElement(j))),d(a,r.slots.register({name:y,key:f},()=>t.default.createElement(L))),()=>{for(let l of[...a].reverse())l()})))),()=>{for(let l of[...a].reverse())l()}})),()=>{for(let r of[...n].reverse())r()}}
+		
+		return module.exports;
+	}
+});

package/lib/index.d.mts

@@ -0,0 +1,51 @@
+import Schema from "@deepseek-ai/schemastery";
+/** 结构等价于 cli 层 LarkRunner（dts 打包不透传子路径类型，故本地声明）。 */
+interface LarkRunnerLike {
+  (args: string[], opts?: {
+    timeoutMs?: number;
+    stdin?: string;
+  }): Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    timedOut: boolean;
+  }>;
+}
+declare const name = "@timeryu/dsh-larklink";
+declare const inject: string[];
+/** 运行时配置（cordis 校验并填充默认值）。 */
+declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
+  home: Schema<string, string, "defined">;
+  execTimeoutMs: Schema<number, number, "defined">;
+  probeTimeoutMs: Schema<number, number, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  home: Schema<string, string, "defined">;
+  execTimeoutMs: Schema<number, number, "defined">;
+  probeTimeoutMs: Schema<number, number, "defined">;
+}>>, "plain">;
+interface SkillService {
+  register(def: {
+    name: string;
+    description: string;
+    content: string;
+    source: string;
+  }): unknown;
+}
+interface PluginCtx {
+  tools: {
+    register(tool: unknown): unknown;
+  };
+  get(service: "skills"): SkillService | null;
+  effect(fn: () => () => void): void;
+}
+interface LarklinkPluginOptions {
+  /** 测试注入 mock runner。 */
+  runner?: LarkRunnerLike;
+}
+declare function apply(ctx: PluginCtx, config?: {
+  home?: string;
+  execTimeoutMs?: number;
+  probeTimeoutMs?: number;
+}, options?: LarklinkPluginOptions): void;
+export { Config, LarklinkPluginOptions, apply, inject, name };